home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / edu / stereogr.zip / QCKSTART.DOC < prev    next >
Text File  |  1994-11-15  |  6KB  |  183 lines
  1.  
  2.             CRUMBLER 2.0  Copyright (C) Carlo Moretti Sep 1994
  3.             ==================================================
  4.  
  5.  
  6.                         written by  Carlo Moretti
  7.  
  8.  
  9.                    e-mail:  moretti@cobra.csr.unibo.it
  10.                        or:  moretti@zeus.csr.unibo.it
  11.  
  12.              
  13.  
  14.                                  QUICKSTART
  15.                                  ==========
  16.  
  17.                              A Quick User Guide
  18.                              ------------------
  19.  
  20.  
  21.  
  22.  INTRO
  23.  =====
  24.  
  25.  CRUMBLER is a SIRDS (Single Image Random Dots Stereogram) and SIS (Single 
  26. Image Stereogram) generator, able to render "TRUE-DEPTH" holusions.
  27.  
  28.  Crumbler 1.x & 2.0 are totally BATCH oriented, so they run using an
  29. extended command line.
  30.  
  31.  
  32.  SYNTAX
  33.  ======
  34.  
  35.  >   CRUMBLER <input[.TGA]> <output[.TGA]> [+<options>]
  36.  
  37.  Input and output are TARGA files; input file can be either compressed or 
  38. uncompressed, 256 gray-shade or 256 indexed coloured or 24 bit truecolor.
  39. The output is ALWAYS truecolor 24 bit, it can be compressed or uncompressed.
  40.  
  41.  
  42.  PARAMETERS
  43.  ==========
  44.  
  45.  Symbol "+" activates the specified option; when CRUMBLER checks the command
  46. line, prints "+<opt.>" for explicated options, while prints "-<opt.>" to 
  47. show other Default values.
  48.  
  49.  Here are the options:
  50.  
  51.  "+p<pattern[.TGA]>"  tells the program to create a SIS and <pattern.TGA> is
  52.         the pattern file you want to superimpose to the Stereogram (it
  53.         can be either compressed, uncompressed, 256c, 256g, 24 bit) 
  54.  
  55.  "+b"   is NOT compatible with "+p<>", neither with "+g". Tells to generate
  56.         BLACK & WHITE SIRDS (so it doesn't need a pattern file)
  57.  
  58.  "+g"   is NOT compatible with "+p<>", neither with "+b". Tells to generate
  59.         a GRAY-SHADE SIRDS.
  60.  
  61.  "+dXXX" tells the input image depth-level. Means the way to read the colours: 
  62.         each colour represent a "depth-level" in the output image.
  63.         Valid values are:
  64.  
  65.         "+d256" : 256 gray-values (Default)                     (SUGGESTED)
  66.         "+d768" : 256(RED) + 256(GREEN) + 256(BLUE)
  67.         "+d4069": RED*16 + GREEN + BLUE/16 (from 3D programs)
  68.         "+d64k" : smoother images from 3D programs              (SUGGESTED)
  69.         "+d16m" : top number of depth-levels
  70.  
  71.         "+d256" is the easiest way to use CRUMBLER. The BRIGHTER pixels
  72.                 becomes THE NEAREST to you in the output stereogram, while
  73.                 the DARKER becomes the farther.
  74.  
  75.  "+r"   is the RESOLUTION in DPI. Default=72 DPI, it depends on your output
  76.         device. This is NOT compatible with "+w" option.
  77.  
  78.  "+w"   is the MAX distance between two repeated patterns. This option can
  79.         replace the "+r" one and it's NOT compatible with.
  80.  
  81.  "+z"   is the Depth of Field. Values greater than 1.0. "+z1.0" generates
  82.         the DEEPEST stereogram, while values greater than 10.0 generate
  83.         'flat' stereograms. Default = 2.0 for Wall-eye, 4.0 for Cross-eye.
  84.  
  85.  "+INT" uses a classical INTEGER algorithm to generate SIS & SIRDS.
  86.         Use this option for "flat" stereograms, which don't need to appear
  87.         smoothed.
  88.  
  89.  "+c"   generates CROSS-EYED stereograms (WALL-EYED is by Default)
  90.  
  91.  "+sXXX" cuts the stereogram into "XXX" slices and invert them.
  92.  
  93.  "+o"   overwrites existing output files.
  94.  
  95.  "+RLE" writes output compressed.
  96.  
  97.  
  98.  
  99.  QUICKSTART: Examples
  100.  ====================
  101.  
  102.  Let's check a command line and say what it does:
  103.  
  104.  CRUMBLER in.tga out.tga +ppatt.tga +d256 +r60
  105.  
  106.  creates a SIS by using "PATT.TGA" as pattern file, and consider a 
  107. gray-shade input image (IN.TGA), by producing a "true-depth" stereogram 
  108. (OUT.TGA) of 60 DPI.
  109.  
  110.  
  111.  CRUMBLER in out +b +int +RLE
  112.  
  113.  creates a black & white SIRDS by using an INTEGER algorithm (non true-depth)
  114. and saving "OUT.TGA" with RLE compression. Input file "IN.TGA" is considered
  115. 256 gray-shade, by Def.
  116.  
  117.  
  118.  CRUMBLER i o +g +s18 +w100
  119.  
  120.  creates a gray-shade SIRDS by repeating a random pattern of max. 100 pixels
  121. per raw, and cuts it into 18 inverted slices.
  122.  
  123.  
  124.  CRUMBLER i o +pp +c +o
  125.  
  126.  overwrites "O.TGA" if already exists and creates a CROSS-EYED SIS.
  127.  
  128.  
  129.  CRUMBLER in ou +d64k +r100 +z1.5
  130.  
  131.  creates a coloured SIRDS (resolution = 100 DPI) quite deep, by using an image
  132. from a 3D program like 3D Studio.
  133.  
  134.  
  135.  CRUMBLER i o +pp +d64k +r80 +s32 +c +o +RLE 
  136.  
  137.  creates an 80 DPI cross-eyed SIS from a 3D image, cuts it in 32 slices,
  138. reverse them and then overwrites "O.TGA" and writes it compressed.
  139.         
  140.  
  141.  INPUT IMAGES
  142.  ============
  143.  
  144.    ===>
  145.    ===>     CHECK CRUMBLER.DOC TO SEE HOW TO CREATE 3D-IMAGES!
  146.    ===>
  147.  
  148.    ===>
  149.    ===>     CHECK CRUMBLER.DOC TO SEE HOW TO CREATE INPUT-IMAGES TOO!
  150.    ===>
  151.  
  152.  Anyway, start drawing a simple WHITE shape (like a filled square or a 
  153. circle) on a BLACK background, then try changing the BRIGHTNESS (using 
  154. simple gray values is the easiest way, to use with "+d256" option) to see 
  155. changes in the depth of the planes.
  156.  
  157.  Then try writing (BIG FONTS) with gray shades, then more complex 
  158. pictures.... In this way you can easily learn by experience.
  159.  
  160.  ALWAYS  check sample files to see how the input images should be.
  161.  
  162.  
  163.  
  164.  PLEASE REGISTER!! 
  165.  =================
  166.  
  167.  Read REGISTER.DOC file to register CRUMBLER 2.0 and the upgrades!!!
  168.  
  169.  
  170.         - QCKSTART.DOC -                 - END -
  171.  
  172.  
  173.  Carlo Moretti.
  174.  
  175.                         internet:       moretti@cobra.csr.unibo.it
  176.                               or:       moretti@zeus.csr.unibo.it
  177.  
  178.                         mail:           Carlo Moretti
  179.                                         V. R.Medri 2050 Gattolino,
  180.                                         CAP 47020, Cesena (FO)
  181.                                                         ITALY
  182.  
  183.